home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / mltshen.lzh / MLT_SHEN.TXT < prev    next >
Text File  |  1994-06-27  |  23KB  |  535 lines
  1. Uptaded to: v1.00
  2. v1.00 only runs on 68000 machines -> not compitable with Falcon or TT (yet).
  3.  
  4.  
  5.      /// //  //  // //   ////// //    \\\\\\   \\  \\ \\\\\ \\\   \\
  6.    // // // //  // //     //   //     \\       \\  \\ \\    \\ \\ \\
  7.   //    // //  // //     //   //      \\\\\\   \\\\\\ \\\\  \\ \\ \\
  8.  //    // /////  ////   //   //            \\  \\  \\ \\    \\ \\ \\
  9.                                        \\\\\\\ \\  \\ \\\\\ \\   \\\
  10.  
  11.  
  12.  
  13.         Multi Shen is an accessory  which  will record everything send
  14. to either printer/rs232/midi/console/vid  console/keyboard ,and revert
  15. to another device. Not only that everything can be 'recorded' into the
  16. memory buffer or reverted  to  printer  direct. If recorded everything
  17. can be replayed as many times  as  you  wish ,as a  backgroung task if
  18. prefered.
  19.  
  20.  
  21. Shareware
  22. =========
  23.  
  24. If you like Multi Shen then  please  register  with us ,see the end of
  25. this file for more information.
  26. However if you don't don't like it  then  the only thing we beg you to
  27. do is not to  use  Multi  Shen  _at_all_.  That  means that you should
  28. delete ALL the copies of Multi Shen  you have ,or give them to someone
  29. else ,but you shouldn't keep any  copies  of it (PD libraries and BBSs
  30. excluded). If you still keep  a  copy  of  this program after using it
  31. _once_ then please be honest ,regiester!
  32.  
  33.  
  34.  
  35. Installing
  36. ==========
  37.  
  38.         Since Multi Shen is an  accessory simply copy MLT_SHEN.ACC and
  39. MLT_SHEN.RSC (MLT_SHEN.INF ,the  configuration  file  may  or  may not
  40. exsist at start) to the root directory  of a disk/hard drive and reset
  41. your ST. MLT_SHEN.ACC may  also  be  loaded  up  in  The Chameleon ,DC
  42. Stuffer or MultiDesk.
  43.  
  44.  
  45.  
  46. Use
  47. ===
  48.  
  49.         The first time Multi Shen  is  called  an info dialog-box will
  50. appear ,read it and click on OK. Now the main dialog-box will appear.
  51.  
  52.         Multi Shen works in the way that  the  user ,in the top of the
  53. main dialog-box  selects  a  device  (printer  ,rs232  ,midi ,keyboard
  54. console or vid console) which will be recorded/reverted from. Only one
  55. device is selectable at  once.Let's  assume  that  you  want to record
  56. everything sent to the printer  then  selct  Printer in the Catch From
  57. boxes.
  58.  
  59. - the console is the same as the screen ,vid console is screen in
  60. transparent format (all ASCII codes can be displayed ,special
  61. characters ,like CR ,LF etc have _no_ effect ) -
  62.  
  63.  
  64.         Next comes the reverting device.  It's best demonstrated as an
  65. example : if you had  selected  Printer  as  the Catch From device and
  66. selct Console  here  then  everything  sent  to  the  printer  will be
  67. displayed on the console! If you  for  example had selected Console as
  68. the Catch From device and select  Printer as the reverting device then
  69. everything sent to the console(screeen)  will  also  be printed on the
  70. printer.
  71.         In addion you can also select Memory Buffer and Printer Direct
  72. as reverting devices. Memory buffer  will  say that the reverting will
  73. go to memory  ,everything  will  be  recored  (copied)  in the memory.
  74. Printer Direct is the same as Printer but Multi Shen will use it's own
  75. routines to access the printer.  It's  _much_  better to selct Printer
  76. Direct then Printer.
  77.  
  78.         Also output to normal port :  Here  you can select between Yes
  79. or No ,simple! This is rather  self-explainery.  Example : If you have
  80. selcted Printer as the  Catch-From  device  and  Printer Direct as the
  81. revert to device ( well ,it may  give faster output on printers ) then
  82. selcting Yes will mean that  each  character  will be printed twice on
  83. the printer. The first time using  Printer  Direct and the second time
  84. using the normal Printer routines.  Select  No and only Printer Direct
  85. will be used.
  86.         If you had selected Printer as  the Catch From device,  Memory
  87. Buffer as Revert to device and select Yes on also outut to normal port
  88. (Printer|Memory Buffer|Yes) then  a  copy  of  everything  sent to the
  89. printer will be made in the memory buffer. The printer will also work.
  90. However select (Printer|Memory  Buffer|No)  and  the  printer will not
  91. work and only a copy will be made in memory.
  92.  
  93.  
  94.  The method to write is:
  95.  
  96.         (Printer|Memory Buffer|No)
  97.            |      |            |
  98.            |      |            |
  99.            |      |            \-> Also output to normal device
  100.            |      |
  101.            |      \-> Revert To Device
  102.            |
  103.            \-> Catch From device
  104.  
  105.  
  106.  
  107.  
  108.  
  109.         Now you may have selected  the  settings  ,but Multi Shen will
  110. still not work ,yet. On  the  right  side  you  can see two icons with
  111. Revert/Record and Stop. Click  on  Revert/Record  icon  and Multi Shen
  112. will start the recording/reverting. Always  remember  to click on Stop
  113. in the end or Multi Shen will continue to do it's work.
  114.         Equally don't  forget  to  click  on  Revert/record  otherwise
  115. nothing will happen.
  116.  
  117.  
  118.  
  119. Memory Buffer
  120. =============
  121.  
  122.         On the bottom you will  see  settings  about the memory buffer
  123. used for recording. The buffer is an  area used by Multi Shen to store
  124. the data caught from a device (say  the  printer). You can write a new
  125. buffer size (in kilobytes) in  the  New  buf.  size area and thereupon
  126. click on Set New Buffer to  set  the  new  buffer size. At default the
  127. buffer is 45K ,but can be set to any length from 0K (no buffer at all)
  128. to 9999K (memory permitting). In the  Memory Buffer above you will see
  129. the current buffer size.  Writing  alone  a  new  buffer  size will do
  130. nothing ,you must always click on Set New Buffer after that.
  131.         In the Reocrded box it  will  be displayed how many kilobytees
  132. have been recorded in the memory.  If  you are not reverting to memory
  133. then of course it should display 0K. Although this buffer size is also
  134. displayed in kilobytes ,but even if 1 byte has been recorded it can be
  135. saved (even though 0K recorded will be displayed).
  136.  
  137.  
  138.         Clicking on Clear Buffer will clear the buffer (0K recorded).
  139.  
  140.         Saving the buffer is done by clicking on Save Buffer (the Disk
  141. icon). The file selector will pop-up  ,select  a  file or write a name
  142. (the .PRN extension is recommended for  printer data) and click on OK.
  143. If nothing has been recorded then an alert-box will come up displaying
  144. that nothing has been recorded and  hence  nothing can be saved. Multi
  145. shen will only save the  data  recored  ,not  the whole buffer. If the
  146. buffer size is 100K and 1K was  recorded in memory then of course only
  147. 1K will be saved.
  148.  
  149.  
  150.         Always select the largest buffer size you possibly can. If the
  151. buffer becomes full then you'll  see  that  the top left-corner of the
  152. screen will blink slowly ,depending  on  how  fast the data is coming.
  153. This data is _not_ recorded by Multi Shen.
  154.  
  155.  
  156.         Clicking on Info will display the Info box.
  157.  
  158.         Clicking  on  Save  CFG   will   save   the  configuration  in
  159. MLT_SHEN.INF. Every setting from  both  the  Replay  and the Main menu
  160. will be stored ,however no file  will  automatically be loaded (in the
  161. Replay menu) and the Stop button in  the  main menu will be active (no
  162. reverting/recording will take place).
  163.         This file will automatically be  loaded  at start-up ,if it is
  164. in the root-directory (in the same place as MLT_SHEN.RSC).
  165.  
  166.  
  167. Shut Down
  168. =========
  169.  
  170.         Multi shen uses various interrupts of  the ST ,and if you want
  171. to change resolutions or unload  Multi  Shen  from the memory then you
  172. must first select Shut Down. If  you  don't Shut Down and unload Multi
  173. Shen or change  resolutions  then  your  machine  will  most likely  a
  174. experience a little crash.
  175.         If you Shut Down then  you  can  still however Reinstall Multi
  176. Shen ,select Reinstall from the alert-box which will appear instead of
  177. the main dialog-box.
  178.  
  179.  
  180.                             /-----------\
  181.                            /  Replaying  \
  182.                           \---------------/
  183.  
  184.  
  185.         This is a very importatnt part  of Multi Shen ,but still works
  186. completely independely of the main  Multi  Shen.  Click on Replay Menu
  187. from the main dialog-box and the  Replay  Menu will come up. The fi